home *** CD-ROM | disk | FTP | other *** search
/ Mac Format 1997 July / macformat52.iso / mac / Resources / ResEdit 2.1.3 / Examples / Instructions
Text File  |  1994-07-15  |  3KB  |  86 lines
  1. Instructions - The ResEdit Examples
  2.  
  3. Copyright Apple Computer, Inc. 1988-1993
  4. All rights reserved.
  5.  
  6. These examples should be used with MPW 3.2 or later.
  7.  
  8. About the Examples
  9.  
  10.     A sample resource editor, picker and LDEF are included with ResEdit.  These examples use
  11.     the MPW environment, the MPW C or Pascal compiler and the MPW Assembler.
  12.  
  13.     The example editor will simply display a window and invert its contents.
  14.     Since the details of editing your resource are known only to you, it is up 
  15.     to you to fill in the code necessary to make this into a real editor.
  16.     
  17.     The example picker is an 'ICON' picker.  The 'ICON' LDEF is included with this 
  18.     example so that you can see the interaction between a picker and its LDEF.
  19.     
  20.     You can find more details about how to use these examples in the ResEdit manual.
  21.     
  22. Building the examples
  23.  
  24.     You can build the examples using the build scripts provided in the
  25.     folder appropriate for the language you’re using.
  26.     
  27.     The build scripts assume that ResEdit and the Examples folder will be found 
  28.     in the directory {boot}ResEdit:.  If these files are located elsewhere, the
  29.     build script files should be modified accordingly.
  30.     
  31.     If ResEdit is successfully located, the MakeFile instructions will install
  32.     the editor, picker and LDEF directly into ResEdit.  When you are experimenting
  33.     with changing any of these files, you may want to build into a copy of ResEdit.
  34.     In this way, if anything goes wrong, you can get a fresh copy of ResEdit for your
  35.     experiments.
  36.     
  37.     
  38. Files included in the Libraries folder
  39.  
  40.     ResDisp.a
  41.         The assembly language interface between the editor or picker and the main
  42.         ResEdit code.  All of the procedures provided in the ResEd interface file
  43.         will be found in this module.  This file should be linked with all editors,
  44.         pickers and LDEFs.
  45.         
  46.     RSSC.a
  47.         The assembly language interface between ResEdit and your editor or picker.
  48.         This file should be linked with your editor or picker.
  49.         
  50.     LDEF.a
  51.         The assembly language interface between the List Manager package and your LDEF.  This
  52.         file should be linked with your LDEF.
  53.         
  54. Files included in the CExample and PExamples folders
  55.  
  56.  
  57.     BuildEditor, BuildPicker, BuildLDEF
  58.         The script files used to install the samples into ResEdit.
  59.         
  60.     MakeEditor, MakePicker, MakeLDEF
  61.         The Make files used by the build scripts.
  62.         
  63.         
  64. Files included in the CExamples:Source: and PExamples:Source: folders
  65.  
  66.     ResEd
  67.         The interface file used by all of the example files.  This file provides an
  68.         interface to procedures provided by the main ResEdit code.  The contents of this
  69.         file are described in the ResEdit manual.
  70.         
  71.     XXXX.Edit
  72.         The main code for the editor.  This is the module that should be
  73.         modified to implement your editor.
  74.  
  75.     ICON.Pick
  76.         The 'ICON' picker from ResEdit.  This file can be used as the starting point
  77.         for creating your own picker. The ResEdit manual describes how to create a 
  78.         'PICK' resource instead of writing your own picker. You’ll need to remove
  79.         the 'PICK' resource named 'ICON' from ResEdit before you can use this example 
  80.         'ICON' picker.
  81.         
  82.     ICON.LDEF
  83.         The LDEF (list definition procedure) used by the ICON picker.
  84.  
  85.  
  86.